Inside Macintosh: QuickDraw GX Printing Extensions and Drivers /

Chapter 5 - Printing Functions for Message Overrides / Printing Functions Reference

Functions / Working With Application Imaging Options

GXAddPrinterViewDevice

You can use the GXAddPrinterViewDevice function to add a view device to the list of view devices that can be used with a printer.

OSErr GXAddPrinterViewDevice (gxPrinter printer,
                              gxViewDevice viewDev);

printer

A reference to a printer object.

viewDev

The view device to associate with the printer.

function result

An error code. The value noErr indicates that the operation was successful.

DESCRIPTION

The GXAddPrinterViewDevice function associates a view device with a specified printer. You call this function from your printer driver to provide information to the application about the kinds of imaging that your printer driver supports for the printer. For example, you can make a view device that is 32 bits deep and associate that with the printer to communicate to the application that your printer driver can manage imaging that is 32 bits deep.

This function increments the owner count of the view device, which means that you still need to call the GXDisposeViewDevice function after calling this function.

RESULT CODES

gxSegmentLoadFailedErr	A required code segment could not be found, or there was not enough memory to load it.
gxPrUserAbortErr	The user has canceled printing.

SEE ALSO

You can find an example of using the GXAddPrinterViewDevice function in
Listing 3-5 on page 3-25 in the chapter "Printer Drivers."

The GXDisposeViewDevice function is described in Inside Macintosh: QuickDraw GX Objects.

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help